home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / programming / other / renderlib / doc / history < prev    next >
Text File  |  1999-06-14  |  20KB  |  588 lines
  1.  
  2. history
  3. -----------------------------
  4.  
  5.   30.0
  6.     - improved memory management: RMHTYPE_POOL allocations are
  7.       now internally semaphore-protected for cross-task
  8.       allocations. this allows guigfx.library (v16) to be reset
  9.       to pooled memory environment.
  10.  
  11.   29.1
  12.     - SortPalette() crashed with sort-modes that required a histogram,
  13.       and when the histogram was a non-TURBO type. this bug hasn't
  14.       been fixed, but 'de-implemented'. SortPalette() now returns
  15.       SORTP_NOT_IMPLEMENTED in this situation.
  16.     - bug fixed in the clib declaration of FreeRenderMem()
  17.  
  18. * 29.0
  19.     - version number bumped
  20.  
  21.   28.4
  22.     - RGBArrayDiversity() was broken, and it returned only nonsense.
  23.       it must have been out of order for eons. fixed.
  24.     - fixed LMSGTYPE_LINE_FETCH linehook messages when applied to scaling
  25.       engines. RND_LMsg_row contained the destination row instead of
  26.       the source row. 
  27.  
  28.   28.3
  29.     - minor clean-ups
  30.  
  31.   28.2
  32.       - fixed overflow problems in texture-mapping engines
  33.       
  34.   28.1
  35.       - fixed EDD dithering with mapping-engines.
  36.       - FS-Dithering with mapping engines didn't render zigzag. fixed.
  37.  
  38.   28.0
  39.       - added EDD dithering. thanks to dante and axis
  40.         for the suggestion.
  41.       - implemented zigzag dithering for floyd-steinberg and EDD.
  42.         (zigzag rendering is not available in HAM modes.)
  43.  
  44.   27.3
  45.       - texturemapping-engines now handle triangles (i.e. when
  46.         one coordinate is specified twice).
  47.       - improved PALMODE_SIGNIFICANCE.
  48.  
  49. * 27.2
  50.       - fixed some semaphore lockup problems with palettes
  51.         and histograms accessed from different tasks. 
  52.  
  53.   27.1
  54.       - fixed a bug in MixAlphaChannel() with one alpha-channel enabled
  55.  
  56.   27.0
  57.       - added internal support functions.
  58.  
  59.   25.1
  60.       - fixed heavy bugs in the texturemapping code and
  61.         optimized it a lot.
  62.  
  63.   25.0
  64.     - implemented texture-mapping via scaling-engines.
  65.  
  66.   24.0
  67.       - added documentation for TintRGBArrayA().
  68.       - added texture-mapping [preliminary, for internal use only].
  69.  
  70.   23.1
  71.       - SortPalette() now uses and updates an already existing
  72.         p2Table. 
  73.  
  74.   23.0
  75.       - added TintRGBArrayA().
  76.  
  77. * 22.4
  78.       - fixed a minor bug when dithering with
  79.         (width % 4) != 0
  80.         - slightly optimized CLUT dither preparation code.
  81.     - slightly modified legal and author text files.
  82.     - added support site URL.
  83.  
  84.   22.3
  85.       - removed some lines of garbage from the HAM-dither code
  86.         that might have caused problems under certain conditions.
  87.  
  88. * 22.2
  89.     - completed autodocs for alpha-channel functions
  90.  
  91.   22.1
  92.       - the internal memcopy routine now handles odd lengths
  93.         and addresses to allow overlapping memory transfers
  94.         in all situations.
  95.  
  96.   22.0
  97.       - implemented CreateAlphaArray()
  98.      - implemented MixAlphaChannel()
  99.      - added tags RND_SourceWidth2, RND_AlphaChannel2,
  100.        RND_AlphaWidth2 and RND_AlphaModulo2 for 3-channel
  101.        alpha-channel operations. it is now possible to
  102.        do 'weighted' compositions with two alpha-channels!
  103.  
  104.   21.0
  105.       - implemented AllocRenderVecClear()
  106.       - added definition of PIXFMT_RGB_24 - this is currently
  107.         not supported by render.library, but required for
  108.         guigfx.library 1.92.
  109.  
  110.   20.3
  111.       - MixRGBArray and ApplyAlphaChannel heavily optimized for
  112.         superscalarity and few memory accesses
  113.       - Histogram creation could still corrupt memory, when
  114.         0xaarrggbb data were added. Fixed.
  115.  
  116.   20.2
  117.     - 'Debug' text file included to the documentation.
  118.     - clib/render_protos.h did not define a return value
  119.       for Chunky2RGB(). Fixed.
  120.     - some text files revised
  121.  
  122. * 20.1
  123.     - fixed FD, clib and pragma files for MixRGBArray().
  124.     - extended ApplyAlphaChannel().
  125.       The alpha-channel is still by default assumed to be
  126.       in the source array, but it may be explicitely set with
  127.       the new tag RND_AlphaChannel. The alphachannel pixel
  128.       modulo may be set with RND_AlphaModulo, and the
  129.       alpha-channel-array's total width can be specified with
  130.       RND_AlphaWidth.
  131.     - fixed ApplyAlphaChannel(), ExtractAlphaChannel() and
  132.       InsertAlphaChannel(): Registers were not preserved
  133.       correctly.
  134.     - tutorial lectored and slightly revised.
  135.  
  136.   20.0
  137.     - implemented MixRGBArray()
  138.     - fixed a bug in Render() and ConvertChunky() when
  139.       rendering with mapping-engines to (width & ~7) != 0
  140.  
  141.   19.9
  142.       - Due to an error in parsing the taglist, ConvertChunky()
  143.         did not use Mapping-Engines. Fixed.
  144.       - ApplyAlphaChannel() fixed.
  145.       - InsertAlphaChannel() function interface slightly modified.
  146.       - tutorial textfile included to the documentation
  147.     - minor optimizations
  148.  
  149.   19.8
  150.     - fixed a bug in Chunky2RGB(). The RND_LeftEdge tag
  151.       was not handled correctly in HAM modes.
  152.       - added InsertAlphaChannel(), ExtractAlphaChannel() and
  153.         ApplyAlphaChannel()
  154.       - Mapping-Engines may be passed to Render() and
  155.         ConvertChunky() now.
  156.       - improved FS-Dithering performance: error calculation
  157.         and shifting now takes place in registers solely. with a
  158.         mapping-engine supplied, the code now fits to a
  159.         68020/68030 instruction cache.
  160.  
  161.   19.7
  162.     - Render() and ConvertChunky() now accept RND_ScaleEngine
  163.       as an additional tag argument. This allows scaling and
  164.       rendering in a single pass. The scaling-engine is
  165.       defined to be applied to to the source data.
  166.     - Scale() now handles RND_LineHook, and it has got a
  167.       returncode.
  168.  
  169.   19.6
  170.     - supplied Chunky2RGB() with RND_LineHook tag
  171.     - ImportPalette() and ExportPalette() PALFMT_RGB4
  172.       were broken. Fixed.
  173.     - implemented PALFMT_PALETTE for ImportPalette().
  174.     - Updated all text files.
  175.     - Lectored and revised autodocs.
  176.     - Added tag RND_Weight for AddHistogram().
  177.     - BestPen() did not work at all. Fixed.
  178.     - BestPen() no longer creates a p2table, but it
  179.       will use it when available.
  180.  
  181.   19.5
  182.     - slightly improved Chunky2RGB() speed in HAM modes
  183.     - included ChunkyArrayDiversity().
  184.     - included MapChunkyArray().
  185.     - Heavy bug removed from ConvertChunky().
  186.  
  187.   19.4
  188.         - AddRGBImage() no longer violates memory with
  189.           0xARGB (A=Alphachannel) data.
  190.         - prevented Render() from false rendering
  191.           with 0xARGB (A=Alphachannel) data. 
  192.         - Updated autodocs for mapping-engines.
  193.         - Implemented RGBArrayDiversity() for Mapping-Engines
  194.           and Palettes.
  195.         - one more bug removed from the palette administration
  196.           code. "Zu wahr um schön zu sein" [I. Jache]
  197.         - removed a small bug in the mapping-engine's
  198.           palette-update-administration code for
  199.           mapping-engines that are coupled with a histogram.
  200.         - added Roadmap.GIF to the documentation.
  201.         - updated autodocs for RGBArrayDiversity().
  202.         - updated memory information text file.
  203.         - updated CPU information text file.
  204.         - CreateMapEngine() no longer handles RND_PenTable.
  205.           This tag has to be passed to MapRGBArray() instead.
  206.  
  207.   19.3
  208.     - Finally- got- rid- of- that- $%^&?#§- palette- bug-
  209.       "I can't eat as much as I want to puke" [Liebermann]
  210.     - Updated legal information text file.
  211.  
  212.   19.2
  213.     - another memory violation bug removed from the
  214.       palette administration code.
  215.  
  216.   19.1
  217.         - ConvertChunky() did not semaphore-protect the
  218.           destination palette correctly. Fixed.
  219.         - Render() did not semaphore-protect the destination
  220.           palette correctly. Exclusive and shared locks to the
  221.           palette nested, and this won't work prior to exec v39.
  222.         - Removed a serious bug inside the palette-buffer
  223.           administration code that was introduced in v19.0
  224.  
  225.   19.0
  226.     - SortPalette() did not semaphore-protect its palette
  227.       and did not invalidate the palette's buffers. Fixed.
  228.         - ConvertChunky() has got a returncode now.
  229.     - Introduced a new functional class: Mapping-Engines.
  230.       Mapping-Engines are low-level conversion units which
  231.       provide mindblasting render speed.
  232.       New functions: CreateMappingEngine(),
  233.       DeleteMappingEngine(), MapRGBArray()
  234.  
  235.   18.9
  236.     - minor bug in HSTYPE_12BIT_TURBO interpolation code fixed.
  237.       The blue component was not correctly interpolated -
  238.       2 bits were missing.
  239.     - Speed heavily improved for most histogram-related functions.
  240.       Especially AddRGBImage() is significantly faster.
  241.  
  242.   18.8
  243.       - ConvertChunky() has been rewritten. Now it is equivalent
  244.         to Render(), except for that it does accept chunky data
  245.         as input and is not able to render to HAM modes. Finally,
  246.         there is no need to convert chunky data to RGB when
  247.         dithering is required.
  248.         ConvertChunky() handles the following additional tags:
  249.         RND_DitherMode, RND_DitherAmount, RND_ProgressHook,
  250.         RND_LineHook, RND_OffsetColorZero. In addition to that,
  251.         the dest-palette's pen-adaptor is correctly handled
  252.         and updated. ConvertChunky() itself is slower than
  253.         before, but overall performance should be better when
  254.         called multiple times.
  255.  
  256.   18.7
  257.       - 18.4 did NOT fix the mentioned bug. Thanks again to
  258.         Stefan Sommerfeld. This bug did not occur in the
  259.         68060 version and I didn't get rid of it. Now fixed.
  260.       - REND_CALLBACK_ABORTED wasn't returned when a 
  261.         Progress-Callback was aborted in Render(). Fixed.
  262.  
  263. * 18.6
  264.     - v18.5 bug removed that produced false dithering with
  265.       15Bit / 18Bit palettes in COLORMODE_CLUT
  266.  
  267.   18.5
  268.       - Render speed improved by up to 40% (depending on the CPU
  269.         and the selected render mode). Remarkably faster on 68060
  270.         systems and CLUT without dithering.
  271.  
  272.   18.4
  273.         - fixed a bug in CreateScaleEngine(). Registers were not
  274.           preserved correctly. Thanks to Stefan Sommerfeld who reported
  275.           this bug.
  276.  
  277.   18.3
  278.     - major internal rework in preparation for new dither modes
  279.       and other features.
  280.  
  281.   18.2
  282.       - Now line hooks have to return TRUE or FALSE for
  283.         continuation respective abortion.
  284.  
  285.   18.1
  286.     - Improved line hooks. A line hook is called twice now:
  287.       Once before rendering a line (msgtype LMSGTYPE_LINE_FETCH),
  288.       once after rendering a line (msgtype LMSGTYPE_LINE_RENDERED).
  289.       This solves many outstanding problems:
  290.       Now you can convert, draw, render, save etc. in a single go,
  291.       and there's no need to have intermediate buffers to keep
  292.       a complete image in memory.
  293.       Also read the annotations in renderhooks.h
  294.  
  295.   18.0
  296.       - removed bug from the 68020 version: Quantization
  297.         crashed without FPU.
  298.       - implemented random dithering (DITHERMODE_RANDOM). 
  299.         New Tag: RND_DitherAmount (Range 0-255).
  300.         The code is not satisfyingly optimized yet.
  301.     - fixed several minor problems
  302.  
  303.   17.6
  304.       - implemented RND_PenTable for Chunky2RGB(). This tag is
  305.         currently not defined for HAM modes.
  306.       - Major internal rework of Render(). Now the
  307.         generalized-line-conversion-interface is used.
  308.       - RND_LineHook implemented to Render().
  309.  
  310.   17.5
  311.       - implemented RND_PenTable tag for Render().
  312.  
  313.   17.4
  314.     - updated the 'legal' text file.
  315.     - minor autodoc changes
  316.  
  317. * 17.3
  318.     - implemented ScaleOrdinate().
  319.  
  320.   17.2
  321.     - removed a bug that occured when a progress hook was aborted
  322.       inside AddChunkyImage: I freed a semaphore that wasn't obtained.
  323.       "Needless to say, havoc breaks out [...]" (exec doc)
  324.  
  325.   17.1
  326.     - minor corrections with the FD and LVO files:
  327.       SortPalette renamed to SortPaletteA, AddHistogram renamed
  328.       to AddHistogramA.
  329.  
  330.   17.0
  331.     - Implemented AddHistogram()
  332.  
  333.   16.3
  334.     - More bugs removed from SortPalette():
  335.       - PALMODE_SIGNIFICANCE crashed in the 68020 and 68040 versions. Fixed.
  336.       - PALMODE_SATURATION did not work at all. Fixed.
  337.       - Bugs removed from PALMODE_POPULARITY and PALMODE_SIGNIFICANCE.
  338.  
  339. * 16.2
  340.     - initial public beta release.
  341.     - removed heavy bugs from SortPalette().
  342.  
  343.   16.1
  344.       - fixed problems with RND_ColorOffsetZero 
  345.  
  346.   16.0
  347.     - mainly cosmetic. major reworks and clean-ups to
  348.       autodoc and includes
  349.  
  350.   15.2
  351.     - Removed a heavy bug from AddRGBImage() that caused
  352.       random crashes.
  353.     - 24bit scaling implemented. The new tag is
  354.       RND_PixelFormat, valid types are PIXFMT_CHUNKY_CLUT
  355.       and PIXFMT_0RGB_32.
  356.  
  357.   15.1
  358.     - The scaling code has been rewritten completely.
  359.       Scaling engines use the generalized conversion system.
  360.       All scaling functions are highly accurate now.
  361.       Horizontal enlarge is significantly faster than before.
  362.  
  363.   15.0
  364.     - introduced a new generalized concept for
  365.       line-oriented conversion functions (internal).
  366.     - Chunky2RGB has been completely rewritten due to this
  367.       new concept. The HAM conversion is much faster now.
  368.     - Added RGB_ProgressHook tag to Chunky2RGB.
  369.     - implemented PMSGTYPE_LINES_CONVERTED.
  370.     - Chunky2RGB has got a returncode (CONV_...).
  371.     - updated the renderhooks include files.
  372.     - finally implemented EXTP_CALLBACK_ABORTED
  373.  
  374.   14.4
  375.     - removed bug from SortPalette().
  376.     - implemented PALMODE_SATURATION sort mode.
  377.  
  378.   14.3    
  379.     - Implemented SortPalette(). RND_PaletteMode is obsolete.
  380.     - New tag for ExtractPalette(): RND_RMHandler. This tag
  381.       specifies a custom memory handler for quantization.
  382.       Default is the histogram's memhandler.
  383.     - EXTP_SORTING_FAILED is obsolete.
  384.     - Default for RND_NewPalette is toggled to TRUE for
  385.       backwards compatibility.
  386.  
  387.   14.2
  388.     - removed heavy bug from AddChunkyImage() that could
  389.       produce completely corrupt histograms.
  390.  
  391.     - introduced PALMODE_SIGNIFICANCE. In this mode, a palette's
  392.       entries are sorted by their optical significance for the
  393.       human eye. This is helpful for many purposes, e.g. you get
  394.       excellent results with ObtainBestPen() if you allocate
  395.       a palette in this sequence.
  396.     - fixed a memory-corruption bug in the quantization code.
  397.  
  398.   14.1
  399.     - RND_NumColors is used instead of RND_NumEntries.
  400.       RND_NumEntries is obsolete. RND_FirstEntry has
  401.       been renamed to RND_FirstColor.
  402.  
  403.   14.0
  404.     - implemented RND_FirstEntry tag for ExtractPalette(),
  405.       ImportPalette() and ExportPalette().
  406.     - implemented RND_NumEntries tag for ImportPalette()
  407.     - implemented semaphore protection for histograms and
  408.       palettes
  409.     - lots of internal reorganization and clean-up
  410.     - implemented FlushPalette()
  411.     - implemented the RND_NewPalette tag for ImportPalette().
  412.  
  413.   13.0
  414.     - fixed minor problems with offset_color_zero and
  415.       p2table-adaption
  416.     - fixed minor problems with ConvertChunky() and
  417.       CreatePenTable() with a secondary pen conversion table
  418.       specified.
  419.     - implemented CountRGB()
  420.     - implemented BestPen()
  421.     - fixed minor problems with CreatePalette()
  422.     - FD and pragma for CreatePenTable() was corrupt. Fixed.
  423.     - CreatePenTable() has been slightly optimized.
  424.  
  425.   12.0
  426.     - adapted CreatePenTable() to palette objects.
  427.     - removed a deadly bug from ImportPalette().
  428.     - added RND_EHBPalette tag for ImportPalette().
  429.     - updated all includes and autodocs.
  430.     - ModifyHistogram() is obsolete. It has been removed.
  431.     - The function interface for QueryHistogram() has been
  432.       changed. You do no longer pass a taglist, but instead
  433.       a single tag argument.
  434.     - Parts of the code have been cleaned up.
  435.  
  436.   11.0
  437.     - adapted autodocs and includes to palette objects.
  438.     - adapted AddChunkyImage to use palette objects.
  439.       AddChunkyImage has been completely rewritten and
  440.       optimized.
  441.  
  442.   10.0
  443.     - adapted Render() to palette objects. 
  444.  
  445.   0.81
  446.     - removed the v0.80 speed-up. It didn't work together with
  447.       the low-memory adaption system.
  448.     - Introduced new functions: CreatePalette(),
  449.       DeletePalette(), ImportPalette(), ExportPalette().
  450.     - Modified ExtractPalette() to operate with palette objects.
  451.  
  452.   0.80
  453.     - The major changes in v0.79 introduced a bug that occured
  454.       when you rendered to HAM modes. This has been fixed.
  455.     - Rendering to CLUT with dither has been sped up.
  456.  
  457.   0.79
  458.     - The color-adaption code was heavily broken for odd
  459.       numbers of palette entries (68020/68040 versions only).
  460.       This long outstanding bug has been fixed.
  461.     - p1Table-Render removed. Instead I've implemented an
  462.       EXTREMELY efficient p2table-Render. Overall performance
  463.       should be at least the same in most cases.
  464.       This step has some profound conceptional consequences.
  465.       It seems as if the whole library layout could be simplified
  466.       even further. Maybe there will be another rework to some
  467.       function interfaces. (Don't kill me, beta-testers...
  468.       this stuff isn't trivial!)
  469.  
  470.   0.78
  471.     - ConvertChunky() is now able to convert a chunky image
  472.       over itself. If you tried to do so with elder versions,
  473.       the result was okay, but the routine was by some hundered
  474.       times slower than it could (reason unknwon).
  475.  
  476.   0.77
  477.     - removed a bug that was introduced in v0.69.
  478.       If you created a turbo histogram, rendered to CLUT
  479.       without dither, and didn't specify a progress hook,
  480.       the code ran into a deadlock.
  481.     - Chunky2RGB() HAM8 bit sequence changed to %SSMMMMMM.
  482.     - Planar2Chunky()'s interface changed and supplied with an
  483.       additional taglist parameter
  484.     
  485.   0.76
  486.     - very nasty bug removed from AddChunkyImageA(). If you
  487.       specified a progress hook, the histogram was completely
  488.       corrupt.
  489.  
  490.   0.75
  491.     - removed a silly bug from Chunky2RGB that was introduced
  492.       in v0.73
  493.     - new tag for CreateRMHandlerA: RMHTYPE_MemFlags.
  494.  
  495.   0.74
  496.     - new autodocs completed.
  497.     - RND_MemHandler renamed to RND_RMHandler.
  498.     - Some constants have changed. You must recompile.
  499.     - Includes once again reworked.
  500.     - new terminology: libcall functions which receive taglist
  501.       parameters end with "...A" instead of "...TagList".
  502.       tagcall vararg stubs no longer end with "...Tags".
  503.  
  504.   0.73
  505.     - a histogram created by CreateHistogram() now has a default
  506.       palette consisting of 16 grey tones.
  507.     - AddChunkyImage() now calls a progress hook. Therefore you
  508.       may specify the RND_ProgressHook tag in AddChunkyImage()'s
  509.       taglist.
  510.     - some optimizations
  511.     - CreateConversionTable() has been renamed to
  512.       CreatePenTable().
  513.     - ConvertChunkyImage() has been renamed to ConvertChunky().
  514.     - RND_ConversionTable has been renamed to RND_PenTable
  515.  
  516.   0.72
  517.     - Heavy bugs removed from AddRGBImage(), ExtractPalette(),
  518.       and other functions.
  519.     - C includes were completely unusable. Fixed.
  520.     - Major rework of most include files.
  521.  
  522.   0.71
  523.     - There were the 0.69 versions of render.library in the
  524.       0.70 archive
  525.     - DeleteScaleEngine() was missing in the includes. Fixed.
  526.     - DeleteScaleEngine() crashed when the scaling-engine wasn't
  527.       created with a custom memhandler.
  528.  
  529.   0.70
  530.     - New interfaces for CreateRenderMemHandler, CreateHistogram,
  531.       Render, AddChunkyImage, AddRGBImage, ExtractPalette,
  532.       SetRenderPalette.
  533.     - Removed SetRGBWeight, SetProgressHook, SetRenderMode,
  534.       SetPaletteMode
  535.     - New functions: ModifyHistogram, QueryHistogram
  536.     - Autodocs not yet updated
  537.  
  538.   0.69
  539.     - p2table searcher now adapts to low-memory situations (not
  540.       fully tested yet)
  541.     - InitPenConversionTable() is no longer defined. A custom
  542.       conversion table may be passed to Chunky2BitMap() directly.
  543.     - p1table adaption callback is now executed every 128th
  544.       adaption. after completion the callback hook is once more
  545.       executed. This corrects minor optical problems with
  546.       progress bars.
  547.     - forgot E include renderhooks.m. Now included.
  548.     - New qualitative color reduction algorithm implemented.
  549.       Slightly faster. Very stable results even with different
  550.       histogram resolutions. Much better output with dither and
  551.       few colors.
  552.  
  553.   0.68
  554.     - I actually forgot to include the SetPaletteMode entry in
  555.       the library's build-up table. The machine crashed when
  556.       executed. Fixed.
  557.     - IMPORTANT: Interface for Scale() has changed - Scale now
  558.       handles two additional arguments: totalwidth for source and
  559.       destination. This allows processing of clip areas.
  560.     - The chunky8 scaling engine now requires less memory.
  561.     - chunky8 scaling optimized for vertical enlarge
  562.     - Heavy autodoc improvements, especially in respect to
  563.       amigaguide links to be created with AD2AG.
  564.  
  565.   0.67
  566.     - new function: SetPaletteMode.
  567.     - some palette sort methods implemented.
  568.     - minor autodoc and includes bugs fixed
  569.     - CreateChunkyConversionTable renamed to
  570.       CreateConversionTable
  571.     - fixed minor accuracy problems with the chunky scaling
  572.       engine
  573.  
  574.   0.66
  575.     - new functions: CreateChunkyConversionTable and
  576.       ConvertChunkyImage.
  577.     - removed two subtle bugs in the FS-dither code. The blue
  578.       error component was treat incorrectly.
  579.  
  580.   0.65
  581.     - CreateScaleEngine8, DeleteScaleEngine und Scale
  582.       implemented.
  583.     - Autodocs updated
  584.  
  585.   0.64
  586.     - initial internal beta release
  587.  
  588.